home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / C64 / C-Communications / (c)c3.d64 / vt52 40_80doc.d < prev    next >
Text File  |  2007-02-04  |  10KB  |  247 lines
  1. ====================================================================
  2.  
  3.                        **** ╔═╨╧╥╘┴╬╘ ****
  4.  
  5.   * ┬┴├╦╙╠┴╙╚┼╙ IN THIS DOCUMENT WILL APPEAR AS ┬╥╔╘╔╙╚-╨╧╒╬─
  6.       SIGNS IF DISPLAYED ON ├OMMODORE EQUIPMENT.
  7.  
  8.   * ╓┼╥╘╔├┴╠ ┬┴╥S WILL APPEAR AS ├OMMODORE GRAPHICS CHARACTERS 
  9.       WHICH ARE SIMILAR TO THE ┴╙├╔╔ CHARACTER.
  10.  
  11.   * ├┴╥┼╘S WILL APPEAR AS ╒╨-┴╥╥╧╫S.
  12.  
  13. =====================================================================
  14.  
  15. ╘HIS PROGRAM MAKES THE ├OMMODORE 64 OPERATE LIKE A SEMI-
  16. INTELLIGENT 40 OR 80 COLUMN ASCII TERMINAL.  ╔T SUPPORTS INPUT
  17. AND DISPLAY OF ALL THE ┴╙├╔╔ CHARACTERS, AND BEEPS WHEN THE ┬┼╠
  18. CHARACTER IS RECEIVED.  ┬EWARE THAT THE 80 COLUMN DISPLAY MODE
  19. WILL PROBABLY REQUIRE A MONITOR UNLESS YOU ARE USING A ┬/╫
  20. ╘╓ SET WITH OUTSTANDING SHARPNESS AND VIDEO BANDWIDTH.
  21.  
  22. ╘HE COMMUNICATION PROTOCOL IS FULL DUPLEX, 8 BITS, NO
  23. PARITY, 1 STOP BIT, 300 OR 1200 BAUD, WITH ╪╧╬/╪╧╞╞ (─├1/
  24. ─├3) HOST FLOW CONTROL PROTOCOL -- THIS SHOULD SATISFY MOST
  25. HOST COMPUTERS.  ╘HE DISPLAY SCREEN IS 40 COLUMNS ╪ 25 LINES
  26. OR 80 COLUMNS ╪ 25 LINES.
  27.  
  28. ┬ECAUSE OF THE UNUSUAL LAYOUT OF THE ├64 KEYBOARD, THE
  29. DESIRE TO SUPPORT ALL ASCII CHARACTERS, AND A PERSONAL
  30. NEED TO FIND THE ┼╙├ AND ┬╙ KEYS IN THEIR USUAL POSITIONS,
  31. THE FOLLOWING KEY SUBSTITUTIONS APPLY (NOTE- ^X IS SHORT-
  32. HAND FOR ├╧╬╘╥╧╠-X):
  33.  
  34. ╘╧ ╙┼╬─         ╘┘╨┼
  35. -------         ----
  36. BACKSLASH       ┬╥╔╘╔╙╚-╨╧╒╬─
  37. ^BACKSLASH      ┬╥╔╘╔╙╚-╨╧╒╬─
  38. ^UNDERSCORE     ^=
  39. CARET           ╒╨-┴╥╥╧╫
  40. ^CARET          ╒╨-┴╥╥╧╫
  41. ^[ (┼╙├)        ^[ OR ┬┴├╦-┴╥╥╧╫
  42. UNDERSCORE      F1
  43. VERTICAL BAR    F2
  44. GRAVE ACCENT    F3
  45. TILDE           F4
  46. LEFT BRACE      F5
  47. RIGHT BRACE     F6
  48. ─┼╠ (╥╒┬)       F7
  49. ^╘              F8
  50. ^╚ (┬╙)         ─┼╠, ^╚, OR ^╘
  51. ^╩ (╬╠)         ╙╚╔╞╘/╥┼╘╒╥╬ OR ^╩
  52. ^╙ (─├3)        ^╙ OR ╚╧═┼
  53. ^╤ (─├1)        ^╤ OR ├╒╥╙╧╥ ─╧╫╬
  54. ^╔ (╘┴┬)        ^╔ (IE. ╬O SEPARATE ╘┴┬ KEY)
  55.  
  56. ╘HE ├╧╬╘╥╧╠-8 KEY IS USED TO SWITCH THE PROGRAM FROM 40 COLUMN
  57. TO 80 COLUMN MODE.  ╘HE ├╧╬╘╥╧╠-4 KEY IS USED TO SWITCH THE
  58. PROGRAM BACK FROM 80 COLUMN TO 40 COLUMN MODE.  ─EPRESSING ONE
  59. OF THESE KEYS WHEN ALREADY IN THE CORRESPONDING MODE WILL SIMPLY
  60. CLEAR THE SCREEN (AS IT DOES WHEN SWITCHING MODES).
  61.  
  62. ╬OTE THAT PRESSING THE ├╧══╧─╧╥┼ KEY WILL PLACE THE TERMINAL
  63. PROGRAM IN A SUSPENDED DISPLAY MODE (IE. THE CURSOR WILL FREEZE
  64. AT IT'S CURRENT POSITION), AND ^╙ WILL BE SENT TO THE HOST
  65. COMPUTER WHEN THE ╥╙-232 INPUT BUFFER FILLS UP.  ╙IMILARLY,
  66. PRESSING THE ├╧══╧─╧╥┼ KEY WILL REMOVE THE TERMINAL FROM THE
  67. SUSPENDED DISPLAY MODE AND SEND A ^╤ TO THE HOST COMPUTER ONLY
  68. IF A ^╙ HAD PREVIOUSLY BEEN SENT AND THE BUFFER HAS BECOME NEARLY
  69. EMPTY.  ╘HIS ENABLES THE ├╧══╧─╧╥┼ KEY TO BE USED LIKE THE ╙├╥╧╠╠/
  70. ╬╧-╙├╥╧╠╠ KEY ON ─┼├ TERMINALS.  
  71.  
  72. ╙USPENDED DISPLAY MODE IS INDICATED TO THE USER BY THE CURSOR 
  73. BLINKING MUCH FASTER THAN NORMAL, AN INDICATION THAT THE ├╧══╧─╧╥┼ 
  74. KEY MUST BE PRESSED TO RESUME DISPLAYING THE RECEIVED TEXT.  
  75.  
  76. ╘HE PROGRAM MAY ALSO SEND ^╙ AND ^╤ TO THE HOST COMPUTER ON ITS 
  77. OWN FROM TIME TO TIME IF IT DETECTS AN IMPENDING ╥╙-232 BUFFER 
  78. OVERFLOW CONDITION - THIS NORMALLY WILL ONLY OCCUR WHILE PRINTING 
  79. A NUMBER OF SHORT OR BLANK LINES WHILE SCROLLING THE SCREEN UP 
  80. (OR DOWN), SINCE 4 TO 15 CHARACTERS ARE RECEIVED INTO THE ╥╙-232 
  81. BUFFER DURING THE TIME IT TAKES TO SCROLL THE WHOLE SCREEN.  
  82. ╔N ANY CASE, THIS AUTOMATIC FLOW CONTROL IS FULLY SYNCHRONIZED 
  83. WITH THE FLOW CONTROL NECESSITATED BY THE USE OF THE ├╧══╧─╧╥┼ 
  84. KEY TO SUSPEND AND RESUME THE DISPLAY OF RECEIVED TEXT.  
  85.  
  86. ─EPRESSING THE ^╙ AND ^╤ KEYS (OR THEIR SUBSTITUTES INDICATED ABOVE) 
  87. UNCONDITIONALLY SENDS THOSE ┴╙├╔╔ CHARACTERS TO THE REMOTE HOST 
  88. COMPUTER WITHOUT ANY LOCAL EFFECT.
  89.  
  90. ╘HIS TERMINAL PROGRAM DOES ╬╧╘ SUPPORT FLOW CONTROL IN THE
  91. OPPOSITE DIRECTION - RECEIVING ^╙ FROM THE HOST COMPUTER WILL NOT
  92. LOCK THE KEYBOARD OR HAVE ANY OTHER EFFECT, NOR WILL ^╤.
  93.  
  94. ┴LSO NOTE THAT PRESSING THE ╥╒╬/╙╘╧╨ KEY WITH ╙╚╔╞╘ DEPRES-
  95. SED WILL CLEANLY TERMINATE THE TERMINAL EMULATOR PROGRAM,
  96. AND GENERATE THE ┬╥╦ INTERRUPT TO SEND THE ├64 BACK
  97. TO WHOEVER IS SERVICING THOSE INTERRUPTS (┬┴╙╔├,
  98. ╙╒╨┼╥═╧╬64,ETC).
  99.  
  100. ┴LL 94 PRINTABLE ASCII CHARACTERS AND THE SPACE WILL
  101. BE DISPLAYED ON THE SCREEN AS RECEIVED OVER THE ╥╙-232
  102. CHANNEL.  ═OST OF THE REMAINING (CONTROL) CHARACTERS ARE
  103. NOT DISPLAYED- HOWEVER THE FOLLOWING CONTROL CHARACTERS
  104. AND ESCAPE SEQUENCES HAVE SPECIAL EFFECTS:
  105.  
  106. ├╚┴╥┴├╘┼╥       ┼╞╞┼├╘
  107. ---------       ------
  108. ^╟ (┬┼╠)        BEEPS THE ╘╓
  109. ^╚ (┬╙)         CURSOR BACKSPACES
  110. ^╔ (╘┴┬)        CURSOR MOVES RIGHT TO NEXT TAB STOP
  111. ^╩ (╬╠)         CURSOR MOVES DOWN ONE LINE WITH SCROLLING
  112. ^═ (├╥)         CURSOR MOVES TO START OF LINE
  113. ^[┴             CURSOR MOVES UP ONE LINE
  114. ^[┬             CURSOR MOVES DOWN
  115. ^[├             CURSOR MOVES RIGHT ONE CHAR.
  116. ^[─             CURSOR MOVES LEFT ONE CHAR.
  117. ^[╚             CURSOR HOMES
  118. ^[╔             CURSOR MOVES UP ONE LINE WITH SCROLLING
  119. ^[╩             CLEARS FROM CURSOR TO END OF SCREEN
  120. ^[╦             CLEARS FROM CURSOR TO END OF LINE
  121. ^[┘LC           CURSOR MOVES TO LINE L-$20, COL C-$20
  122. ^[┌             SENDS ─┼├ ╓╘-52 TERMINAL ID STRING
  123. ^[N             TURNS OFF REVERSE VIDEO
  124. ^[O             TURNS ON REVERSE VIDEO
  125. ^[^\            INITIATES DOWNLINE LOAD
  126.  
  127. ╘AB STOPS ARE PRE-DEFINED AND FIXED AT EVERY 8 COLUMNS
  128. BEGINNING WITH COLUMN 0 (IE. 0, 8, 16, 24, ...).
  129.  
  130. ╘HE REST SHOULD ALL BE PRETTY MUCH SELF EXPLANATORY EXCEPT
  131. FOR "DOWNLINE LOAD".  ╧NCE THE ^[^\ SEQUENCE HAS BEEN RE-
  132. CEIVED, THE PROGRAM EXPECTS LINES TO COME IN OVER THE ╥╙-
  133. 232 CHANNEL OF THE FORM:
  134.  
  135. ;LLHHDDDDDDDDDD...
  136.  
  137. WHERE "LLHH" IS THE ADDRESS FOR THE FIRST.BYT OF DATA
  138. ON THE LINE (IN 6502 LOW/HIGH FORMAT), AND "DDDDDD.."
  139. ARE THE DATA.BYTS THEMSELVES - NOTE THAT THE ADDRESS
  140. MUST BE 4 HEXADECIMAL DIGITS AND EACH DATA.BYT MUST
  141. BE 2 HEXADECIMAL DIGITS.  ╘HE LOAD IS TERMINATED NORMALLY
  142. BY RECEPTION OF THE CONTROL CHARACTER ^^, OR ABNORMALLY
  143. IF THE USER HITS A KEY ON THE ├64 KEYBOARD DURING THE
  144. LOAD.  ╔N THE 40 COLUMN MODE, ╔T IS POSSIBLE TO LOAD ANYWHERE
  145. IN THE ADDRESS RANGES $0800 THROUGH $9FFF AND $C000 THROUGH
  146. $CFFF SINCE THE TERMINAL PROGRAM ITSELF HIDES UNDER THE ┬┴╙╔├
  147. ╥╧═ (FROM $A000 THROUGH $BFFF).  80 COLUMN MODE SHOULD NOT
  148. BE USED TO DOWNLOAD INTO THE ADDRESS RANGE $5C00 THROUGH
  149. $7FFF BECAUSE THAT IS WHERE THE HIGH RESOLUTION VIDEO MATRIX
  150. AND SCREEN IMAGE RESIDE IN THAT MODE.
  151.  
  152. ╓┴╪ ╒╬╔╪ USERS (┬ERKELEY 4.1BSD) WILL FIND THAT THE FOLLOWING
  153. "TERMCAP" ENTRIES EFFECTIVELY DESCRIBE THIS TERMINAL PROGRAM
  154. FOR USE WITH THE TERMINAL DEPENDENT ╒╬╔╪ PROGRAMS (EG. VI,
  155. EMACS, MORE, ROGUE, ETC.):
  156.  
  157. QC▌C64▌├64▌├OMMODORE 64:CO#40:LI#25:\
  158.         :AM:PT:BW:\
  159.         :UP=\┼┴:HO=\┼╚:DO=\┼┬:\
  160.         :ND=\┼├:SO=\┼O:SE=\┼N:CE=\┼╦:\
  161.         :CD=\┼╩:SR=\┼╔:BC=\┼─:\
  162.         :CL=\┼╚\┼╩:CM=\┼┘%+ %+ :\
  163.         :KU=^┬:KD=^╨:KR=^╘:KL=^┼:
  164.  
  165.  QD▌C64W▌├64╫▌├OMMODORE 64 80 ├OL ╪ 25 ╠IN:CO#80:LI#25:\
  166.         :AM:PT:BW:\
  167.         :UP=\┼┴:HO=\┼╚:DO=\┼┬:\
  168.         :ND=\┼├:SO=\┼O:SE=\┼N:CE=\┼╦:\
  169.         :CD=\┼╩:SR=\┼╔:BC=\┼─:\
  170.         :CL=\┼╚\┼╩:CM=\┼┘%+ %+ :\
  171.         :KU=^┬:KD=^╨:KR=^╘:KL=^┼:
  172.  
  173. ╓┴╪ ╓═╙ USERS CAN PROBABLY GET AWAY WITH THE FOLLOWING (ALTHOUGH
  174. SOME ╓═╙ PROGRAMS [EG. EDT] REQUIRE AN AUXILLIARY KEYPAD, AND DO
  175. NOT WORK ESPECIALLY WELL IN 40 COLUMN MODE):
  176.  
  177.          SET TERM /DEV=VT52
  178.          SET TERM /PAG=25
  179.          SET TERM /WID=80  [OR 40, AS THE CASE MAY BE]
  180.  
  181. ╘╧╨╙-20 USERS CAN RUN "EMACS" AND THE LIKE AFTER THE FOLLOWING:
  182.  
  183.          TERM VT52
  184.          TERM LENGTH 25
  185.          TERM WIDTH 80  [OR 40, AS THE CASE MAY BE]
  186.          TERM PAUSE COM
  187.  
  188. ┴ LOW PITCHED BEEP (MUCH LOWER THAN THAT GENERATED BY
  189. RECEIPT OF THE ┬┼╠ CHARACTER) INDICATES AN ERROR ON THE
  190. ╥╙-232 CHANNEL (A HIT, LOST DATA, ETC).
  191.  
  192. ╧F COURSE, THIS PROGRAM ASSUMES YOU HAVE BEEN ABLE
  193. TO CONNECT A MODEM (OR NULL MODEM) TO THE ├64 USER
  194. PORT, WHICH MAY OR MAY NOT BE TRIVIAL!
  195.  
  196. ╘O RUN THE TERMINAL PROGRAM, JUST LOAD IT LIKE ANY ┬┴╙╔├
  197. PROGRAM AND ╥╒╬ IT.  ┘OU WILL BE PROMPTED FOR THE BAUD
  198. RATE.  ┼NTER EITHER 3 OR 300 FOR 300 BAUD, 12 OR 1200
  199. FOR 1200 BAUD, OR JUST A CARRIAGE RETURN FOR THE DEFAULT
  200. (300 BAUD).  ╔F YOU FIND COMMUNICATIONS SHAKY OR IMPOS-
  201. SIBLE AT 1200 BAUD, YOU MAY HAVE TO CHANGE THE POKE IN
  202. BASIC WHICH POKES 0 TO POKE 8 INSTEAD.  ╔F THIS FAILS TO
  203. HELP, TRY TUNING THE OPTIONAL BAUD RATE CONSTANTS IN 0A4F
  204. AND 0A50 FOR YOUR SYSTEM CLOCK AS DESCRIBED IN REF. GUIDE
  205. PAGE 350 (USE POKE OF 0 INTO 0A4D IN THIS CASE).
  206.  
  207. ╧NCE IT HAS BEEN RUN, THE TERMINAL PROGRAM MOVES ITSELF
  208. UNDER THE ┬┴╙╔├ ╥╧═ AND RUNS THERE (ALTHOUGH THE ORIGINAL
  209. COPY REMAINS WHERE IT WAS LOADED AND CAN BE RE-RUN AS LONG
  210. AS IT REMAINS INTACT).  ╘HE MEMORY MAP AT RUN TIME IS:
  211.  
  212. $A080-$AFFF     ╘HE PROGRAM AREA
  213. $B000-$B1FF     ╒NUSED
  214. $B200-$B2FF     ╥╙-232 OUTPUT BUFFER
  215. $B300-$B3FF     ╥╙-232 INPUT BUFFER
  216. $B400-$B7FF     ╓IDEO MATRIX (THE 40 COLUMN SCREEN)
  217. $B800-$BFFF     ├HARACTER SET FOR 40 COLUMN MODE
  218. $02A7-$02B6     ╘ERMINATION/╥ESTART CODE
  219.  
  220. ╔N ADDITION, THE FOLLOWING MEMORY AREAS ARE USED ONLY WHILE THE
  221. PROGRAM IS IN THE 80 COLUMN MODE:
  222.  
  223. $5C00-$5FFF     ╓IDEO MATRIX (THE 80 COLUMN COLOR MEMORY)
  224. $6000-$7FFF     ╚IRES SCREEN (THE 80 COLUMN SCREEN)
  225.  
  226. ╧NCE THE TERMINAL PROGRAM HAS BEEN TERMINATED (WITH ╙╚╔╞╘/
  227. ╥╒╬/╙╘╧╨), IT MAY BE RE-STARTED BY RE-RUNNING THE ORIGINAL
  228. ┬┴╙╔├ PROGRAM.  ╚OWEVER, IF THE ┬┴╙╔├ PROGRAM AREA HAS BEEN
  229. OVER-WRITTEN DURING DOWNLOADING, THE TERMINAL PROGRAM CAN
  230. STILL BE RESTARTED (AT THE SAME BAUD RATE AS BEFORE) WITH
  231. THE ┬┴╙╔├ DIRECT COMMAND "╙┘╙(686)"; THIS COMMAND WILL
  232. RESTART THE TERMINAL PROGRAM AT ANY TIME, EVEN AFTER RUNNING
  233. OTHER PROGRAMS, UNLESS SOME PROGRAM IS RUN WHICH POKES
  234. INTO THE AREAS SHOWN IN THE FIRST MAP ABOVE.
  235.  
  236. ╧NE LAST WARNING: THIS PROGRAM IS NOT RELOCATABLE - DO
  237. NOT CHANGE THE *LENGTH* OF THE ┬┴╙╔├ PROGRAM OR NOTHING
  238. WILL WORK!
  239.  
  240. ╟OOD ╠UCK AND ┼NJOY....
  241.         ╞RANK ╨RINDLE
  242.  
  243. (3) ╬╒?ER-WRITTEN DURING DOWNLOADING, THE TERMINAL PROGRAM CAN
  244. STILL BE RESTARTED (AT THE SAME BAUD RATE AS BEFORE) WITH
  245. THE ┬┴╙╔├ DIRECT COMMAND "╙┘╙(686)"; THIS COMMAND WILL
  246. RESTART THE TERMINAL PROGRAM AT ANY TIME, EVEN AFTER RUNNING
  247. OTHER E